home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / os2 / sfutils.zip / SFUTILS.INF (.txt) < prev    next >
OS/2 Help File  |  1997-04-29  |  27KB  |  786 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. SFUtils description ΓòÉΓòÉΓòÉ
  3.  
  4. SFUtils (Startup Folder Utilities) consists of two utilities, ObjWait and 
  5. AppWait, and a helper utility for ObjWait, MakeObj. 
  6.  
  7. AppWait and ObjWait have the same purpose--to allow applications stored on a 
  8. network drive to be run by the OS/2 startup folder at bootup. Until the network 
  9. drives are available, they display a dialog box that indicates, "Waiting for 
  10. x:". 
  11.  
  12. The two "Wait" utilities take different approaches to solving this problem, and 
  13. have different strengths and weaknesses. They are described in their own 
  14. sections and there is a chart that compares their features. 
  15.  
  16.       ObjWait 
  17.  
  18.       AppWait 
  19.  
  20.  SFUtils may be purchased for personal or site use. Please see Licensing 
  21.  information. 
  22.  
  23.  Installation 
  24.  
  25.  
  26. ΓòÉΓòÉΓòÉ 2. ObjWait and AppWait features ΓòÉΓòÉΓòÉ
  27.  
  28. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  29. ΓöéFeature                                      ΓöéObjWait ΓöéAppWait Γöé
  30. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  31. ΓöéProgram objects required                     Γöé2       Γöé1       Γöé
  32. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  33. ΓöéObject Id required                           ΓöéY       ΓöéN       Γöé
  34. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  35. ΓöéNumber of drives that can be waited for      Γöé24      Γöé2       Γöé
  36. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  37. ΓöéCan start OS/2, DOS, Win, bat, and cmd       ΓöéY       ΓöéY       Γöé
  38. Γöésessions                                     Γöé        Γöé        Γöé
  39. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  40. ΓöéCan choose specific DOS/Win settings         ΓöéY       ΓöéN       Γöé
  41. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  42. ΓöéCan choose program session type              ΓöéY       ΓöéN       Γöé
  43. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  44. ΓöéApplication object is hatched while app runs ΓöéY       ΓöéY       Γöé
  45. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  46. ΓöéApplication object is hatched while waiting  ΓöéN       ΓöéY       Γöé
  47. Γöéfor network drives                           Γöé        Γöé        Γöé
  48. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  49. ΓöéObject in startup folder remains hatched     ΓöéN       ΓöéY       Γöé
  50. Γöéwhile app runs                               Γöé        Γöé        Γöé
  51. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  52. ΓöéDouble clicking object brings program to     ΓöéY       ΓöéY       Γöé
  53. Γöéforeground                                   Γöé        Γöé        Γöé
  54. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  55.  
  56.  
  57. ΓòÉΓòÉΓòÉ 3. Installation ΓòÉΓòÉΓòÉ
  58.  
  59. Place the distribution files in any directory on a local hard drive. They don't 
  60. have to be in a directory in your path as long as you specify the full path 
  61. when you set up your applications. 
  62.  
  63. No changes to config.sys are necessary, and there are no workplace shell 
  64. classes to register. 
  65.  
  66. For the MakeObj help to function, MakeObj must be run from the directory where 
  67. the help file is stored. Alternately, you can put the help file in a directory 
  68. listed in the HELP= line of config.sys. 
  69.  
  70.  
  71. ΓòÉΓòÉΓòÉ 4. ObjWait ΓòÉΓòÉΓòÉ
  72.  
  73. ObjWait takes as parameters the drive letters you want to wait for, and the 
  74. object id of a Workplace Shell object you want to open. ObjWait waits for each 
  75. drive letter to be available, and then opens the object you specified. 
  76.  
  77. With ObjWait, you will need at least two program objects. One program object 
  78. will be for ObjWait itself, and will go in the startup folder. The other 
  79. program object will be for the application you want to run. If the ObjWait 
  80. object is double clicked, it checks for the specified drives (as many as you 
  81. specify) and then opens the specified application object. The ObjWait icon will 
  82. not remain hatched while the application is running. Double clicking the 
  83. ObjWait object again will bring the application to the foreground. 
  84.  
  85. ObjWait works equally well with any type of program object including OS/2, DOS, 
  86. or Windows programs. You can set specific session options and DOS settings and 
  87. they will all be honored just as if you had opened the object directly. 
  88.  
  89. Before you can use ObjWait, you must usually create a new application program 
  90. object that has a specific object id. MakeObj makes this easy to do, and a Rexx 
  91. sample is included that can be modified to automate the process. 
  92.  
  93.       ObjWait quick start 
  94.       ObjWait tutorial 
  95.       ObjWait advanced topics 
  96.       Feature chart 
  97.       AppWait 
  98.  
  99.  
  100. ΓòÉΓòÉΓòÉ 4.1. ObjWait quick start ΓòÉΓòÉΓòÉ
  101.  
  102. Run MakeObj and follow the online help to create a startup object and an 
  103. application object. Complete the settings of the application icon so it starts 
  104. your application. 
  105.  
  106. Reboot your system and logon to the network and your application will start. 
  107.  
  108. For more detailed information, please see the ObjWait tutorial and ObjWait 
  109. advanced topics. 
  110.  
  111.  
  112. ΓòÉΓòÉΓòÉ 4.2. ObjWait tutorial ΓòÉΓòÉΓòÉ
  113.  
  114. There are usually two steps you will take to setup ObjWait to start an 
  115. application. 
  116.  
  117.    1. Create two new icons using MakeObj (one for the startup folder and a new 
  118.       application icon). 
  119.  
  120.    2. Edit the new application object to have the correct settings to run your 
  121.       application. 
  122.  
  123.  That's it. Now you can reboot and logon to the network, your applications 
  124.  should start. 
  125.  
  126.  For more information on ObjWait see Advanced topics 
  127.  
  128.  
  129. ΓòÉΓòÉΓòÉ 4.2.1. Using MakObj ΓòÉΓòÉΓòÉ
  130.  
  131. MakeObj creates a startup object and an application object with an object id. 
  132. It is one of the utilities in SFUtils. 
  133.  
  134. Run MakeObj and fill in the required fields. Online help is available. 
  135.  
  136.    1. Enter a name for your application object 
  137.  
  138.    2. Enter an object id.
  139.  
  140.       Note:  All object id's must be unique so you might want to use your 
  141.       initials or some other unusual identifier as part of the id. Also, the id 
  142.       must begin with < and end with > 
  143.  
  144.    3. Enter the full path to ObjWait. 
  145.  
  146.    4. Choose the network drive letters you want to wait for by clicking on 
  147.       them. 
  148.  
  149.    5. Press create and one icon will appear on your desktop and one will be 
  150.       added to your startup folder. 
  151.  
  152.  Errors are usually caused by one of two problems. An object id that is not 
  153.  unique, or an appliction name that is not unique on the desktop. Try again 
  154.  with different names. 
  155.  
  156.  Once the icons are successfully created, you can exit MakeObj and go onto the 
  157.  next step. 
  158.  
  159.  
  160. ΓòÉΓòÉΓòÉ 4.2.2. Application object ΓòÉΓòÉΓòÉ
  161.  
  162. The next step is to edit the settings of the new object you created so that it 
  163. starts your application. 
  164.  
  165. MakeObj will open the settings notebook for the new object, and you can open 
  166. the settings notebook for your original application. 
  167.  
  168. OS/2 program settings 
  169.  
  170. For OS/2 programs, you need only copy the info from the three fields on the 
  171. "Program" page. This can easily be done using OS/2's copy and paste features. 
  172.  
  173. DOS and Windows settings 
  174.  
  175. For DOS and Windows Applications you need to copy the DOS settings in addition 
  176. to the program page as discussed for OS/2 programs. 
  177.  
  178. If you are running OS/2 Warp you can use the Print (to file) option from the 
  179. DOS Settings window to save all the settings from the old object into a 
  180. temporary file. You can then use the Load option from the DOS Settings window 
  181. of the new object. 
  182.  
  183. If you have OS/2 v2 you will need to manually copy the DOS settings. You can 
  184. change to the settings page and open the DOS settings window of the new and old 
  185. objects. Then change each setting in the new object to be the same as the 
  186. setting in the old object. 
  187.  
  188. Once your application object is setup correctly you can reboot and see ObjWait 
  189. in action. 
  190.  
  191.  
  192. ΓòÉΓòÉΓòÉ 4.3. ObjWait advanced topics ΓòÉΓòÉΓòÉ
  193.  
  194. Using your existing application object 
  195.  
  196. If you have utilities (not supplied with SFUtils) that can determine an 
  197. object's id, or set an id for an existing object, you don't need to run 
  198. MakeObj. You can instead manually create an object to be put in in the startup 
  199. folder. This startup object should have objwait.exe as the program name; the 
  200. drive letters you want to wait for as the first parameter; and the object id as 
  201. the second parameter. (See useage below). 
  202.  
  203. The author is aware of Object Utility/2 (supplied with Visual Age C++) that can 
  204. determine the id of an object. (Note that many objects don't have id's.) The 
  205. author is also aware of Deskman/2 (from Devtech) that allows you to determine 
  206. object id's and assign object id's. 
  207.  
  208. Starting file objects with ObjWait 
  209.  
  210. ObjWait can start file objects in addition to program objects. File objects are 
  211. the objects the workplace shell displays in the drives folder for your 
  212. executable files. To start these objects, simply list the full path to the file 
  213. object as the second parameter to ObjWait (and don't use < and >). 
  214.  
  215. Creating objects with REXX 
  216.  
  217. A command file SMakeObj.cmd is included that prompts for input and then creates 
  218. program objects. You can modify this sample to automate the process of setting 
  219. up ObjWait to start applications. 
  220.  
  221. ObjWait Useage (parameters) 
  222.  
  223. OBJWAIT  DRIVE_LETTERS OBJECTID 
  224.  
  225. The following example waits for drives F: G: H: and Q: and then starts the 
  226. object that has the id <MY_OBJECT>: 
  227.  
  228. ObjWait FGHQ <MY_OBJECT>
  229.  
  230.  
  231. ΓòÉΓòÉΓòÉ 5. AppWait ΓòÉΓòÉΓòÉ
  232.  
  233. AppWait takes as parameters an application filename, a working directory, and 
  234. the parameters you want to pass to the application. AppWait waits for the drive 
  235. letters referenced in the filename and directory to be available, then the 
  236. AppWait screen disappears and the application is started. 
  237.  
  238. AppWait uses only one program object. You can use the original object or a 
  239. shadow in your startup folder. The program icon will have hash marks while the 
  240. program is running. Double clicking on the running object will bring the 
  241. application to the foreground. 
  242.  
  243. AppWait works very well for OS/2 programs and OS/2 command files. It can also 
  244. be used with DOS programs, DOS batch files, and Windows programs, but you 
  245. cannot choose any special DOS settings or set the session type. 
  246.  
  247. You cannot specify additional drive letters. AppWait only waits for the drive 
  248. the executable is on and the drive the working directory is on. 
  249.  
  250. AppWait.exe is very similar in operation to Linkup.exe provided with Warp 
  251. Connect. Linkup waits for a TCP/IP connection, and AppWait waits for network 
  252. drives. 
  253.  
  254.       AppWait quick start 
  255.       AppWait tutorial 
  256.       AppWait examples 
  257.       AppWait formal useage syntax 
  258.       Feature chart 
  259.       ObjWait 
  260.  
  261.  
  262. ΓòÉΓòÉΓòÉ 5.1. AppWait quick start ΓòÉΓòÉΓòÉ
  263.  
  264. Modify or create a program object. 
  265.  
  266.    1. The Path and file name field should be the full path to AppWait.exe. 
  267.  
  268.    2. The Parameters field should contain the following parameters in the 
  269.       following order. 
  270.  
  271.         a. Full path to the app you want to start. 
  272.         b. Full working directory for your app. 
  273.         c. Parameters to pass to your app (0 or more). 
  274.  
  275.    3. The program object's working directory is ignored and can be left blank. 
  276.  
  277.  For more detailed information, see the following: 
  278.  
  279.       AppWait tutorial 
  280.  
  281.       AppWait examples 
  282.  
  283.       AppWait useage syntax 
  284.  
  285.  
  286. ΓòÉΓòÉΓòÉ 5.2. AppWait tutorial ΓòÉΓòÉΓòÉ
  287.  
  288. The following are step by step instructions to set up a program object with 
  289. AppWait: 
  290.  
  291.    1. Create a new program object 
  292.  
  293.       You can drag a program object off the Program template in the templates 
  294.       folder 
  295.  
  296.       You can click on a program object and type create another. 
  297.  
  298.       Or, you can modify a program object you already have for your app. 
  299.  
  300.    2. On the program page of the object, fill in the path and file name field 
  301.       with AppWait.exe 
  302.  
  303.       If you haven't installed AppWait to a directory on your path, you must 
  304.       enter the full path name. (For instance, if you have Appwait in 
  305.       c:\utilities, enter c:\utilities\appwait.exe) 
  306.  
  307.    3. In the parameters field, supply information about your app. 
  308.  
  309.            For OS/2 or DOS EXE 
  310.            For OS2 CMD files 
  311.            For DOS BAT files 
  312.            For Windows EXE 
  313.  
  314.    4. The working directory field of the AppWait object can be left blank. It 
  315.       is overidden by the working directory passed to appwait. 
  316.  
  317.    5. Set the icon for the program object. 
  318.  
  319.       This can be done in several ways. Here is one method. 
  320.  
  321.  Now you can reboot and see AppWait in action. 
  322.  
  323.  
  324. ΓòÉΓòÉΓòÉ 5.2.1. Starting OS/2 or DOS EXE ΓòÉΓòÉΓòÉ
  325.  
  326. For OS/2 or DOS executables, pass AppWait the following parameters. Note that 
  327. the parameters must be in the correct order. 
  328.  
  329.    1. Full path to the executable 
  330.  
  331.    2. Full path of the working directory 
  332.  
  333.    3. Parameters for your app 
  334.  
  335.  Example (OS/2) 
  336.  
  337.  Example (DOS) 
  338.  
  339.  Useage syntax 
  340.  
  341.  
  342. ΓòÉΓòÉΓòÉ 5.2.2. Starting OS2 CMD files ΓòÉΓòÉΓòÉ
  343.  
  344. For OS/2 CMD files, pass AppWait the following parameters. Note that the 
  345. parameters must be in the correct order. 
  346.  
  347.    1. cmd.exe 
  348.  
  349.    2. Full path of the working directory 
  350.  
  351.    3. /cFILENAME.CMD  where FILENAME.CMD is the name of your command file. (You 
  352.       can include the path if needed.) 
  353.  
  354.    4. Parameters for your command file. 
  355.  
  356.  Example 
  357.  
  358.  Useage syntax 
  359.  
  360.  
  361. ΓòÉΓòÉΓòÉ 5.2.3. Starting DOS BAT files ΓòÉΓòÉΓòÉ
  362.  
  363. For DOS BAT files, pass AppWait the following parameters. Note that the 
  364. parameters must be in the correct order. 
  365.  
  366.    1. command.com 
  367.  
  368.    2. Full path of the working directory 
  369.  
  370.    3. /cFILENAME.BAT  where FILENAME.BAT is the name of your batch file. (You 
  371.       can include the path if needed.) 
  372.  
  373.    4. Parameters for your batch file. 
  374.  
  375.  Example 
  376.  
  377.  Useage syntax 
  378.  
  379.  
  380. ΓòÉΓòÉΓòÉ 5.2.4. Starting Windows EXE ΓòÉΓòÉΓòÉ
  381.  
  382. For Windows EXE, pass AppWait the following parameters. Note that the 
  383. parameters must be in the correct order. 
  384.  
  385.    1. winos2.com  (try win.com if this doesn't work) 
  386.  
  387.    2. Full path of the working directory 
  388.  
  389.    3. The executable name. (You can include the path if needed.) 
  390.  
  391.    4. Parameters for the windows app. 
  392.  
  393.  Example 
  394.  
  395.  Useage syntax 
  396.  
  397.  
  398. ΓòÉΓòÉΓòÉ 5.2.5. Setting the icon ΓòÉΓòÉΓòÉ
  399.  
  400. Open the settings of an object that has the correct icon. 
  401.  
  402.    1. Change to the general page. 
  403.  
  404.    2. Press the edit button and the icon editor should open. 
  405.  
  406.    3. Choose File Save, and enter a temporary name. 
  407.  
  408.    4. Use the drives object to open the folder where you temporarily saved the 
  409.       icon. 
  410.  
  411.    5. Change to the general page of the AppWait object you are creating, and 
  412.       drag and drop the icon from the folder onto the icon area of the general 
  413.       page. 
  414.  
  415.  
  416. ΓòÉΓòÉΓòÉ 5.3. AppWait examples ΓòÉΓòÉΓòÉ
  417.  
  418. See the following for examples of using AppWait. 
  419.  
  420. In each example, it is assumed AppWait.exe is in the c:\util directory, and the 
  421. c:\util directory is not in the path. 
  422.  
  423.       For OS/2 EXE 
  424.  
  425.       For DOS EXE 
  426.  
  427.       For OS2 CMD files 
  428.  
  429.       For DOS BAT files 
  430.  
  431.       For Windows EXE 
  432.  
  433.  
  434. ΓòÉΓòÉΓòÉ 5.3.1. Example for OS/2 or DOS EXE ΓòÉΓòÉΓòÉ
  435.  
  436. A program object with the following settings will start Describe from the h: 
  437. drive with a default directory of c:\describe. The file name 
  438. c:\describe\data\todo will be passed as a parameter. 
  439.  
  440. Path and file name: 
  441.  
  442.    c:\util\appwait.exe
  443.  
  444. Parameters: 
  445.  
  446.    h:\describe\describe.exe c:\describe c:\describe\data\todo
  447.  
  448. Working directory: 
  449.  
  450. Useage syntax 
  451.  
  452.  
  453. ΓòÉΓòÉΓòÉ 5.3.2. Example for DOS EXE ΓòÉΓòÉΓòÉ
  454.  
  455. A program object with the following settings will start Wordperfect from the h: 
  456. drive with a default directory of h:\wpData, and the file name h:\WpData\todo 
  457. will be passed as a parameter. 
  458.  
  459. Path and file name: 
  460.  
  461.    c:\util\appwait.exe
  462.  
  463. Parameters: 
  464.  
  465.    h:\wp51\wp.exe h:\wpData h:\WpData\todo
  466.  
  467. Working directory: 
  468.  
  469. Useage syntax 
  470.  
  471.  
  472. ΓòÉΓòÉΓòÉ 5.3.3. Example for CMD ΓòÉΓòÉΓòÉ
  473.  
  474. A program object with the following settings will run the command file 
  475. copyNew.cmd with a working directory of f:\newfiles, and pass c:\latest as a 
  476. parameter. 
  477.  
  478. Path and file name: 
  479.  
  480.    c:\util\appwait.exe
  481.  
  482. Parameters: 
  483.  
  484.    cmd.exe f:\newfiles /ccopyNew.cmd c:\latest
  485.  
  486. Working directory: 
  487.  
  488. Useage syntax 
  489.  
  490.  
  491. ΓòÉΓòÉΓòÉ 5.3.4. Example for BAT ΓòÉΓòÉΓòÉ
  492.  
  493. A program object with the following settings will run the batch file 
  494. copyNew.bat with a working directory of f:\newfiles, and pass c:\latest as a 
  495. parameter. 
  496.  
  497. Path and file name: 
  498.  
  499.    c:\util\appwait.exe
  500.  
  501. Parameters: 
  502.  
  503.    command.com f:\newfiles /ccopyNew.bat c:\latest
  504.  
  505. Working directory: 
  506.  
  507. Useage syntax 
  508.  
  509.  
  510. ΓòÉΓòÉΓòÉ 5.3.5. Example for Windows EXE ΓòÉΓòÉΓòÉ
  511.  
  512. A program object with the following settings will run America Online with a 
  513. working directory of m:\aol30. 
  514.  
  515. Path and file name: 
  516.  
  517.    c:\util\appwait.exe
  518.  
  519. Parameters: 
  520.  
  521.    winos2.com m:\aol30\aol.exe m:\aol30
  522.  
  523. Working directory: 
  524.  
  525. Useage syntax 
  526.  
  527.  
  528. ΓòÉΓòÉΓòÉ 5.4. AppWait useage syntax ΓòÉΓòÉΓòÉ
  529.  
  530. The following sections show the formal useage syntax for AppWait to start 
  531. different types of applications. 
  532.  
  533.       For OS/2 or DOS EXE 
  534.  
  535.       For OS2 CMD files 
  536.  
  537.       For DOS BAT files 
  538.  
  539.       For Windows EXE 
  540.  
  541.  The general syntax is: 
  542.  
  543.      AppWait  APP_NAME  APP_WORKING_DIRECTORY  PARAMETERS_FOR_APP
  544.  
  545.  
  546. ΓòÉΓòÉΓòÉ 5.4.1. Useage for OS/2 or DOS EXE ΓòÉΓòÉΓòÉ
  547.  
  548. AppWait  APP_NAME  APP_WORKING_DIRECTORY  PARAMETERS_FOR_APP
  549.  
  550. Example (OS/2) 
  551.  
  552. Example (DOS) 
  553.  
  554.  
  555. ΓòÉΓòÉΓòÉ 5.4.2. Useage for CMD ΓòÉΓòÉΓòÉ
  556.  
  557. AppWait cmd.exe WORK_DIRECTORY /cCMD_NAME PARAMS_FOR_CMD
  558.  
  559. Example 
  560.  
  561.  
  562. ΓòÉΓòÉΓòÉ 5.4.3. Useage for BAT ΓòÉΓòÉΓòÉ
  563.  
  564. AppWait command.com WORK_DIRECTORY /cBAT_NAME PARAMS_FOR_BAT
  565.  
  566. Example 
  567.  
  568.  
  569. ΓòÉΓòÉΓòÉ 5.4.4. Useage for Windows EXE ΓòÉΓòÉΓòÉ
  570.  
  571. AppWait winos2.com WORK_DIRECTORY APP_NAME PARAMS_FOR_APP
  572.  
  573. (if this doesn't work on Warp red spine, try win.com instead of winos2.com) 
  574.  
  575. Example 
  576.  
  577.  
  578. ΓòÉΓòÉΓòÉ 6. Licensing information ΓòÉΓòÉΓòÉ
  579.  
  580. The trial version of SFUtils may only be used for evaluation purposes and must 
  581. be registered for continued use. 
  582.  
  583. You may purchase a personal or site license. 
  584.  
  585. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  586. ΓöéType      ΓöéCost      ΓöéDescription              Γöé
  587. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  588. ΓöéPersonal  Γöé$15       ΓöéFor use on one machine   Γöé
  589. Γöélicense   Γöé          Γöé                         Γöé
  590. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  591. ΓöéSite      Γöé$150      ΓöéFor use on any number of Γöé
  592. Γöélicense   Γöé          Γöémachines at one site     Γöé
  593. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  594.  
  595. SFUtils can be purchased through BMT Micro or directly from the author 
  596.  
  597.  
  598. ΓòÉΓòÉΓòÉ 6.1. Purchase through BMT Micro ΓòÉΓòÉΓòÉ
  599.  
  600. You can order from BMT Micro using the enclosed purchase applet. It allows you 
  601. to fill out your order information and then encrypts it and sends it via the 
  602. internet to BMT Micro. It will also print out a form that you can fax or mail. 
  603.  
  604. BMT Micro also has an 800 number for telephone orders. BMT Micro can be 
  605. contacted as shown below. 
  606.  
  607.                Secure Web Orders: http://www.bmtmicro.com
  608.  
  609.                   Mail Orders To: BMT Micro
  610.                                   PO Box 15016
  611.                                   Wilmington, NC 28408
  612.                                   U.S.A.
  613.  
  614.                     Voice Orders: 8:00am - 7:00pm EST (-5 GMT)
  615.                                   (800) 414-4268 (orders only)
  616.                                   (910) 791-7052
  617.  
  618.                       Fax Orders: (910) 350-2937  24 hours / 7 Days
  619.                                   (800) 346-1672  24 hours / 7 Days
  620.  
  621.          Online Orders via modem: (910) 350-8061  10 lines, all 14.4K
  622.                                   (910) 799-0923  Direct 28.8K line
  623.  
  624.      Ordering and general ordering questions:
  625.                          Via AOL: bmtmicro
  626.                          via MSN: bmtmicro
  627.                      Via Prodigy: HNGP66D
  628.                   via Compuserve: 74031,307
  629.                     via Internet: orders@bmtmicro.com
  630.                                   telnet@bmtmicro.com
  631.                                   http://www.bmtmicro.com
  632.  
  633.  
  634.      We accept Visa, Mastercard, Discover, American Express, Diners
  635.      Club, Carte Blanche, Cashiers Check, Personal Check.   Personal
  636.      checks are subject to clearance.  Eurochecks in DM are welcome.
  637.      DM, Sterling, and US Currency is welcome but send only by
  638.      registered mail, return reciept requested.   We cannot be liable
  639.      for lost cash sent through the mail.
  640.  
  641.      Purchase orders are welcome, subject to approval.   The minimum
  642.      amount is $250.00.
  643.  
  644.      Information for our German customers is explained in the last
  645.      paragraph of this order form.
  646.  
  647.      Shipping and Handling:
  648.  
  649.        Email - Subject to Credit Card Verification     Free
  650.        Worldwide 1st Class .......................     Free
  651.        2nd Day Priority, USA Only ................ $   4.00 US
  652.        US Postal Service International Express
  653.          (Including Canada and Mexico), allow up to
  654.          7-10 days ............................... $  25.00 US
  655.        Airborne Select Delivery  (USA Only)        $   8.00 US
  656.        FedEx Overnight, USA Only (delivery by
  657.          3:00 pm the following day) .............. $  15.00 US
  658.        FedEx Europe/Japan (guaranteed delivery
  659.          within 3 days) .......................... $  35.00 US
  660.  
  661.                    ORDERING FROM INSIDE GERMANY ONLY
  662.                    =================================
  663.  
  664. Persons in Germany wishing to order shareware may also transfer funds
  665. into our account with Deutsche Bank.   Once the money is deposited you
  666. may either fax a confirmation to us with proof of deposit or wait until
  667. Deutsche Bank notifies us of the transaction (usually 10-18 business days).
  668. Account information is as follows:
  669.  
  670. Deutsche Bank / Frankfurt Branch
  671. Empf╨önger:  Thomas Bradford / BMT Micro
  672. Konto-Nummer: 0860221
  673. Bankleitzahl: 500-700-10
  674.  
  675. When you make the transfer, be sure to put your name and the program you
  676. are registering on the transfer.
  677.  
  678. Current exchange rates can be obtained by sending an email to
  679. dm_to_us@bmtmicro.com.   An automated reply will return todays exchange
  680. rates.
  681.  
  682. It is very important that you send us a completed order form by
  683. either email or fax if you deposit money into this account for a
  684. registration.  Fill the order form out as usual except in the credit
  685. card number field put "DEUTSCHE BANK".   We will file the order and
  686. use it to match against the deposit information we receive from the
  687. bank.
  688.  
  689.                                IMPORTANT!
  690.                                ----------
  691. When you email us your order form, we will reply with an
  692. acknowledgement.   If you do not get an acknowledgement within 24 hours
  693. please send your order again in case it was lost.  This extra bit of
  694. caution can save a lot of confusion.
  695.  
  696. If you are concerned that your order is taking too long to process, feel
  697. free to check with us about the status of your order.   It's important
  698. to all of us that you feel safe doing business with our company and
  699. please feel free to suggest ways we can improve our service to you.
  700.  
  701.  
  702. ΓòÉΓòÉΓòÉ 6.1.1. Purchase applet ΓòÉΓòÉΓòÉ
  703.  
  704. The purchase applet is purchase.exe included in this distribution. 
  705.  
  706.    Instructions, Information, and the obligatory legal requirements
  707.   ----------------------------------------------------------------
  708.  
  709. %%%%%%%%%%%%%%%%% DISCLAIMER %%%%%%%%%%%%%%%%%%%
  710.  
  711. THE USER OF THE PROGRAM BY USING IT AGREES NOT TO HOLD BMT MICRO, INC.
  712. NOR ITS OWNERS NOR ITS EMPLOYEES LIABLE FOR ANY DAMAGE THAT MAY HAVE
  713. BEEN CAUSED BY EITHER THE PROPER OR IMPROPER FUNCTIONING OR BY THE USE
  714. OR MISUSE OF THE PURCHASE APPLET.
  715.  
  716. %%%%%%%%%%%%%%% END OF DISCLAIMER %%%%%%%%%%%%%%%%%
  717.  
  718.  
  719. Tip:  If you have an account with BMT Micro, Inc., put your PIN number
  720. ====  in the credit card field.
  721.  
  722. 1.  The BMT Micro, Inc. purchase applet requires that you be connected
  723.   to the internet to submit an online order.
  724.  
  725. 2.  Your online order is encrypted prior to being sent.  We make no
  726.   claims about the ability of another party to intercept and decipher
  727.   your online order.  In fact, the chances of an online order being
  728.   intercepted is exactly the same as any other email message you send.
  729.   The encryption routine does provide an extra layer of security.  I
  730.   personally would have no problem using this application to send an
  731.   order but if you are really, really concerned about security please
  732.   use our secure web server to place an order at http:\\www.bmtmicro.com.
  733.  
  734. 3.  When you send an order the program also creates a text file named
  735.   register.frm.  Please print this and save it as a record of your
  736.   order.
  737.  
  738. 4.  If you wish to pay by means other than a credit card the program
  739.   will print an order form suitable for mailing.  The printed order
  740.   form has our mailing address.
  741.  
  742. 5.  The pricing of the products in the list is current as of
  743.   April 29, 1997.  If for any reason there is a price difference
  744.   between the current price and the listed price we will contact you
  745.   via email prior to processing the order.  Under no circumstances
  746.   will we bill you any amount higher than is quoted on the order form.
  747.  
  748. 6.  BMT Micro, Inc. makes no claims for this purchase applet.  If you
  749.   place an online order and do not hear from us within 24 hours please
  750.   contact us at bmt@bmtmicro.com and we'll check it out.   You can
  751.   expect to hear from us even in the case of declined credit cards or
  752.   orders that cannot be processed for any reason.
  753.  
  754.  
  755. ΓòÉΓòÉΓòÉ 6.2. Purchase through author ΓòÉΓòÉΓòÉ
  756.  
  757. You may order SFUtils directly from the author: 
  758.  
  759.  
  760.   Darren V. Croft
  761.   PO Box 711706
  762.   Salt Lake City, UT  84171
  763.  
  764.   Send a check in US funds
  765.  
  766.   Specify email or postal delivery.
  767.  
  768.   Include email address for update notification.
  769.  
  770.   ( email dvc@ibm.net with questions )
  771.  
  772.  
  773. ΓòÉΓòÉΓòÉ 7. Tech support ΓòÉΓòÉΓòÉ
  774.  
  775. All support is handled by the author either via email or postal mail. 
  776.  
  777. BMT Micro does not handle tech support. 
  778.  
  779. Please contact:
  780.  
  781.   dvc@ibm.net
  782.  
  783.   Darren Croft
  784.   PO Box 711706
  785.   Salt Lake City, UT  84171
  786.